.. :validated: 3.1.0

Установка глобального каталога
------------------------------

Модуль ГК может быть установлен во время продвижения первого КД.

Для этого достаточно установить пакет ``aldpro-gc`` и добавить ключ ``--setup_gc`` при вызове утилиты ``aldpro-server-install``.

Важно помнить, что для установки необходима роль глобального каталога. Если роль глобального каталога не была установлена сразу, то ее можно добавить позднее на любой контроллер домена через портал управления на странице **Роли и службы сайта** → **Служба глобального каталога**. В противном случае, при очередном обновлении конфигурации сервер автоматически удалит модуль ГК. КД, которому будет назначена новая роль, автоматически обновит конфигурацию через полчаса.

Для форсирования установки роли на сервере необходимо использовать команды:

.. code-block:: bash

   sudo DEBIAN_FRONTEND=noninteractive apt-get install -q -y aldpro-gc
   sudo aldpro-gc --action install

.. important::

   Вне зависимости от процесса установки ГК (форсированной или по расписанию) текущий установщик глобального каталога вносит изменение в конфигурацию плагина ``Retro Changelog`` сервера 389ds. Чтобы это изменение было применено, необходимо выполнить команду:

   .. code-block:: bash

      sudo ipactl restart

Проверить работу глобального каталога после его установки можно командой:

.. code-block:: bash

   sudo aldproctl status --service=globalcatalog